APPENDIX A 

Data Transfer Request (DTR) File -- for use with X_ETL_DEFINEREC 
/* General notes: 

* 1 . The DTR file is comprised of DTR commands that define the data transfer between 

* the GCOS and Unix machines in behalf of the RDBC utilities running on Unix. 

* 2. A DTR command may be expressed on a single line or across multiple lines. 
5 * An individual token within a DTR command may not be split across 

* multiple lines. Multiple DTR commands on the same line is not supported. 

* 3. Supported DTR commands: OPTION and RECORDFORMAT. 

* 4. Required Order of DTR commands: OPTION (if present), 

* followed by RECORDFORMAT. 

10 * 5. RECORDFORMAT field requirements: All fields of data record must be 

* explicitly defined. 
*/ 

<OptionCmd>::= OPTION <OptionStmt> [<OptionStmt>...] ; 
<OptionStmt>::= <ConvStmt> | <IndStmt> | <ByteflipStmt> 



15 



= <ConvStmt>::= -CONVERT {YES |NO} /* default is YES */ 

y <ByteflipStmt>::= -BYTEFLIP {YES|NO} /* default is YES */ 

;rf 20 <IndStmt>::= -INDICATORS {YES|NO} | <NumIndBits> /* default is NO */ 

<NumIndBits>::= /* integer value indicating number of Indicator bits */ 

~4 /* Miscellaneous notes: 

p 25 * 1 . "-INDICATORS YES" implies that the number of Indicator Bits is 

~ * the number of <FieldDesc> fields contained in the RECORDFORMAT command. 



ry 
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/* */ 

<RecFormatCmd>::= RECORDFORMAT <FieldDesc> [,<FieldDesc>...] ; 

<FieldDesc>::= <fieldname> ( <datatype> ) 

35 <fieldname>::= /* alpha-numeric string indicating name of record field */ 

<datatype>::= BYTE (n) | BYTEINT | CHAR (n) | DATE | DECIMAL (x) 

DECIMAL (x,y) | FLOAT | GRAPHIC (n) | INTEGER | LONG VARBYTE | 
LONG VARCHAR | LONG VARGRAPHIC | SMALLINT | VARBYTE (n) | 
40 VARCHAR (n) | VARGRAPHIC (n) 
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Data Transfer Request (DTR) File -- for use with X ETL DEFINEREC 
/* Miscellanous notes: 

* 1 . Data types LONG VARB YTE and LONG VARCHAR imply a maximum 

* length of 64000 1-byte elements (64000 bytes). 

* 2. LONG VARGRAPHIC implies a maximum length of 32000 2-byte 

* elements (64000 bytes). 

* 3. All tokens comprising an individual <FieldDesc> must be contained on 

* the same line. 
*/ 
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